home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 426-450 / disk_445 / optmouse / optmouse.doc < prev    next >
Text File  |  1992-05-06  |  3KB  |  93 lines
  1.  * OptMouse.c
  2.  *
  3.  * Serial Port Optical Mouse Driver
  4.  *
  5.  * (c) Copyright 1989 J. Edward Hanway
  6.  *              149 Scotch Pine Dr.
  7.  *              Rochester, NY 14616
  8.  *
  9.  * This code may be freely redistributed for non-commercial purposes. There
  10.  * is NO WARRANTY on this program. The author assumes no responsibility for
  11.  * any damages resulting from use of this program. You know the drill.
  12.  *
  13.  
  14. Usage (from CLI only):
  15.     OptMouse [-m[iddle]] [device [unit]]
  16.     OptMouse [-k[ill]]
  17.  
  18. Examples:
  19.     OptMouse         Starts mouse driver (in the background) on
  20.                 serial.device, unit 0.
  21.  
  22.     OptMouse foo.device 1    Starts mouse driver using foo.device, unit 1.
  23.                 Unit is optional, but if you want a unit other
  24.                 than zero, you must specify the device, even
  25.                 if it's just serial.device.
  26.  
  27.     OptMouse -middle    Starts mouse driver. Translates middle button
  28.     OptMouse -moo        events into shift-left button events. 
  29.  
  30.     OptMouse -m foo.dev 1    You get the idea.
  31.  
  32.     OptMouse -kill        Stops mouse driver. (Frees serial port.)
  33.     OptMouse -kwack
  34.  
  35. Background:
  36.     The M3 (or M2) is a serial, optical mouse made by Mouse Systems
  37.     Corp. of Santa Clara, CA.  They are very nice, true optical mice (as 
  38.     in no-moving parts, not the "opto-mechanical" market-speak like
  39.     the Amiga mouse) and are (were? still?) used by Sun Microsystems
  40.     for their workstations.  According to the "Optical Mouse Technical
  41.     Reference Manual" the mice come with a variety of connectors, including
  42.     ones which have DB25 serial connectors and are powered by a separate
  43.     power pack, but    the one I got had an RJ11C (modular telephone)
  44.     connector, which I wired to get power from the Amiga 2000 serial port
  45.     as follows:
  46.  
  47.     DB25S                        RJ11C
  48.     to Amiga                    to mouse
  49.                   3+------+    
  50.     Pin 3 (Data) ----------|      |2
  51.                   1|      |------------- Pin 4 (Signal)
  52.     Pin 10 (-12V)----------| 1488 |        
  53.                  14|      |7
  54.               +----|      |----------------------------+
  55.               |    +------+                   |
  56.               |                       |
  57.               |   1+------+3               |
  58.     Pin 9 (+12V) -----+----| 7805 |----+-------- Pin 3 (+5V)   |
  59.               |    +---+--+    |               |
  60.            .01uF ===      2|      === .01uF           |    
  61.               |       |       |               |
  62.     Pin 7 (GND)  -----+--------+-------+---+---- Pin 2 (GND)   |
  63.                            |           |
  64.                            +-------------------+
  65.     
  66.     I managed to cram this circuit inside a DB25-to-modular adapter.
  67.  
  68. Caveats:
  69.     As far as I can tell, the events that this program generates are
  70.     identical to genuine mouse events, but Digi-Paint (version 1)
  71.     doesn't like me, and hangs when I use the optical mouse to try to
  72.     load a picture. I know of no other incompatibilies with "normal"
  73.     programs which read the mouse via Intuition. Games which take over
  74.     the machine and/or go straight to the hardware will obviously not
  75.     work.
  76.  
  77.     Gurus, which require you to click the left mouse button to continue,
  78.     apparently go straight to the hardware (what else can they do?) and,
  79.     thus, don't work.
  80.  
  81.     I have not tested this with any add-on serial port (I can't afford
  82.     them). Even if I could, half of a $300 board for a mouse when you
  83.     can buy the Boing optical mouse for $100 ain't very cost-effective,
  84.     so I suppose this will remain just a hack unless (until?) the price
  85.     of add-on serial ports comes down severely.
  86.     
  87.     Apparently these mice can be had for cheap at hamfests, etc. because
  88.     they're not strictly compatible with a PC, I guess. If you do find
  89.     one, make sure you get the reflective mouse pad with it!
  90.  
  91. Disclaimer:
  92.     Mouse Systems has nothing to do with this and has never heard of me.
  93.